home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
BBS Toolkit
/
BBS Toolkit.iso
/
doors_1
/
as24.zip
/
AS.DOC
< prev
next >
Wrap
Text File
|
1992-04-27
|
36KB
|
762 lines
┌┬┬┬┬┬┬┬┬┬┬┬─┐
││││││││││││ │
││││││││││││ │
││││││││││││ │ ┌───────────┐
││││││││││││ │ │ ┌────────┘
├┴┴┴┴┴┴┴┴┴┴┤ │ │ │ ┌─────────────┐
└┬─────────┴┬┘ │ │ │ ┌───────┐ │
┌──┴──────────┴────────┐ │ │ │ │ │ │
│ │ │ │ │ │ │ │
│ │ │ └─────────┘ └───────┘ │
└──────────────────────┘ └────────────┐ ┌──────────┘
│ │
│ │
│ │
│ │
└──┘
C O M P U T E R P R O F I L E S
5012 OLDE MILL DRIVE, MARIETTA, GA, 30066
AutoScribe
V 2.4
Release Version 2.4
Copyright (c) 1991 Gary R. Smith
All Rights Reserved
License to Use Agreement
───────────────────────────────────────────────────────────────────────
Computer Profiles, (herein referred to as CP), grants to the
purchaser and purchaser accepts a non-transferable and
nonexclusive license to use, on a single computer, the software
products and accompanying materials provided to the purchaser by
CP. Purchaser is hereby licensed only to read the program from
its medium into the memory of a single computer solely for the
purpose of executing the program.
CP shall have the right to terminate this license if purchaser
violates any of its provisions. Purchaser agrees that the
software products and accompanying materials are the property of
CP and that CP shall maintain title to and ownership of the
software products at all times. Purchaser agrees to make no more
than one (1) additional working copy and one (1) backup copy of
the software products for their personal use only.
CP makes no warranties of any kind, expressed or implied, with
respect to the quality, performance, accuracy, or fitness of the
software products for any particular purpose. CP assumes no
responsibility for any decisions make or actions taken on the
part of the purchaser because of the use of the software
products. In no event shall CP, or any of its representatives,
be liable for any loss of profit or any other damages, arising
out of the use or inability to use this product - even if CP or
an authorized agent of such has been advised of the possibility
of such damages - or for any claim by any other party.
CP reserves the right to make changes, enhancements and
improvements to the software products at any time without
notice.
DISCLAIMER
───────────────────────────────────────────────────────────────
There is made no warranty of any kind, express or implied
including without limitation, any warranties of merchantability
and / or fitness for a particular purpose. CP shall not be
liable for any damages, whether direct, indirect, special or
sequential arising from a failure of this program to operate in
the manner desired by the user. CP shall not be liable for any
damage to data or property which may be caused directly or
indirectly by the user of this program.
IN NO EVENT WILL CP BE LIABLE TO YOU FOR ANY DAMAGES, INCLUDING
ANY LOST PROFITS, LOST SAVINGS OR OTHER INCIDENTAL OR
CONSEQUENTIAL DAMAGES ARISING OUT OF YOUR USE OR INABILITY TO
USE THE PROGRAM, OR FOR ANY CLAIM BY ANY OTHER PARTY.
AutoScribe is a Trademark of Computer Profiles
Borland C++ is a Registered Trademark of Borland International
CKIT is a Trademark of Data-Comp Information Systems
PCBoard is a Registered Trademark of Clark Development Company
AutoScribe 2.4 INTRODUCTION
──────────────────────────────────────────────────────────────────────────
ORDERING INSTRUCTIONS may be found in the register.doc file.
Features of AutoScribe:
o User friendly interfaces for both the SYSOP and the USER!
o Auto-Registration (Instantly!) for PCBoard 14.5+ systems!
(Other BBS Systems may use the Credit Card Features!)
o Supports up to 50 different subscription levels
o Configurable to accept Visa! MasterCard! or American Express!
and many more popular credit cards!
o Instantly verifies different card types!
o Sysop defined registration levels, costs, tax, and handling
charges.
o Displays in color / non -- color modes!
o Detects Loss of carrier!
o Can operate at speeds in excess of 115000 Baud!
o Will automatically log user off after 3 minutes of no keyboard
activity!
o Written completely in Borland C++!
NEW ITEMS!
o NEW ASM (AutoScribe System Manager) program to facilitate writing
the configuraton file.
o NEW @CODE Support. Now you can truely create your own receipts
and invoices!
o NEW toggle to turn on dots to hide the credit card number from
onlookers.
o NEW Code added to format the credit card numbers when written to the
file.
o NEW improved credit card verification routines!
o NEW PURCHASE.(Node Number) file written to disk for sysop to
inform them of a completed purchase.
AutoScribe 2.4 INTRODUCTION
──────────────────────────────────────────────────────────────────────────
Upgrading Information
When you purchase AutoScribe you will receive a registration
number that will remove all restrictions from the version you
are using. There are no time restrictions placed on a particular
version of AutoScribe.(ie. No yearly fees. You own this version)
Bug fixes and ammendments are free and may be downloaded from the
support bbs.
AutoScribe 2.4 GETTING STARTED
──────────────────────────────────────────────────────────────────────────
AutoScribe Setting Up
For those of you who have never setup doorware for Bulletin Board
Systems before, you will be walked through some of the most basic
procedures to ensure that you setup your copy of AutoScribe properly
the first time with minimum work and time. For those of you who are
experienced please bear with us.
Creating a AutoScribe must have its own directory to run from.
directory Create a directory from which you wish to run the program
from. This name may be any name as long as it conforms to
DOS standards. We suggest running it from a sub directory
like the following example.
C:\PCB\DOORS\ASCRIBE
We will use the above example for the remainder of this
setup session. Create the directory by moving to your bbs
directory PCB\DOORS and type MD ASCRIBE
Copy the You now must copy the files from your distribution disk or
files shareware zip file to the newly created directory.
Example.
Copy ASxx.ZIP C:\PCB\DOORS\ASCRIBE
Your ASxx.zip file will now be located in the directory
in which you created for AutoScribe (tm).
Unpacking If you received your version of AutoScribe from a Bulletin
the files Board you will have to have a copy of PKUNZIP in your path.
Once you are in your AutoScribe directory type the
following (Where xx is the version number of the copy you
received).
Example. PKUNZIP ASxx.ZIP
Construct To run AutoScribe from most bulletin boards you will
a batch file need to construct a batch file that your Bulletin Board
Software will use to call the AutoScribe program. If you
are running multinodes of AutoScribe you will want to
make use of environment variables provided by your
software.
AutoScribe 2.4 GETTING STARTED
──────────────────────────────────────────────────────────────────────────
By creating this batch file you are configuring it so
AutoScribe will run for that node. Each batch file you
create should be like the following example. (Assuming we
are configuring for a single Node) (The Users file in
line 3 is only for PCBoard 14.5+ systems)
AS - (PCBoard Version)
Line 1 @ECHO OFF
Line 2 CD C:\PCB\DOORS\AS
Line 3 AS AS.CNF C:\PCB\PCBOARD.SYS C:\PCB\MAIN\USERS
Line 4 CD C:\PCB
Line 5 BOARD
AS - (PCBoard Multinode Version)
Line 1 @ECHO OFF
Line 2 CD C:\PCB\DOORS\AS
Line 3 AS.EXE AS.CNF %PCBDRIVE%PCBDIR%\PCBOARD.SYS
C:\PCB\USERS
Line 4 CD %PCBDIR%
Line 5 BOARD
AS - (Other BBS Version)
Line 1 @ECHO OFF
Line 2 CD C:\BBS\DOORS\AS
Line 3 AS AS.CNF DOOR.SYS
Line 4 CD C:\BBS
Line 5 BBS COMMAND
Meanings:
Line 1 Turns off the Local Screen Echo (DOS 3.3 and up)
Line 2 Changes the directory to where AutoScribe is stored
Line 3 (1) AutoScribe Executable Statement
(2) The complete path to that nodes PCBoard.sys,
DOOR.sys, Generic.sys file
(3) If you are using a PCBoard 14.5 system and you
have AutoRegistration turned on in the config
file, you must put the path to your users file
here. (ALL other type bbs's leave blank)
Line 4 Changes the directory back to the PCB directory
Line 5 Calls the PCBoard program / or your bbs program
NOTE: Your AutoScribe batch file should be similar to the
example above, Line 3 however, Must contain the path
to the pcboard.sys or door.sys type file.
This file is to be placed in the PCBoard or BBS directory.
AutoScribe 2.4 GETTING STARTED
──────────────────────────────────────────────────────────────────────────
Adding to The next step to setup AutoScribe is to add it to your
BBS Doors Bulletin Boards Doors file. If you use PCBoard this is
file done through the PCBoard SETUP program. All that needs
to be done once you are in PCBSETUP editor for doors
is place the name of the batch file you just created
above in a slot for a door, give it a minimum security
level and your all done. If you prefer to use the
door.sys information make sure you select to create a
door.sys file. You should use PCBOARD.SYS if you intend
to use instant registration.
This completes the basic setup of AutoScribe. Please read
further to configure AutoScribe to run with your database
and software.
EDITING/ The AS.DAT file contains the data about your registration
CREATING THE process. The data in this file MUST conform to the
AS.DAT FILE standards setforth in this document.
Each subscription level in the file consists of TWO lines
of Data
Line 1 is a 50 character limited line that is a
description of the registration level the user will
purchase such as the following example.
(Design your own if you like!)
ex. "60 Mins a Day 4 Months 1000K Daily D/L Limit"
|----------------- 50 Characters---------------|
Line 2 consists of three (3) parts
ex. 20.00,120,35
(This example depicts a $20.00 charge for 4 months and
the user receives a security level of 35)
Part 1 - Price, The cost of the subscription is placed
here followed by a comma.
Part 2 - Days, The length of the subscription is placed
here, such as 120 = 4 months, 60 = two months etc.
Part 3 - Security Level, The security level the user will
receive is placed here. ENSURE that any security
level you put here is also noted by PCBoard. If
Not you will get the error "NO SECURITY LEVEL
MATCH IN PASSWRD FILE".
Your final lines should resemble the following:
60 Mins a Day 4 Months 1000K Daily D/L Limit
20.00,120,35
AutoScribe 2.4 GETTING STARTED
──────────────────────────────────────────────────────────────────────────
Without skipping a line you can place your next line of
descriptions up to 15. (Unregistered versions will only
utilize the first line).
ex. 60 Mins a Day 4 Months 1000K Daily D/L Limit
20.00,120,35
120 Mins a Day 12 Months 2000K Daily D/L Limit
60.00,365,55
This file is located in the AutoScribe directory.
* if you are using the option to display your own subscription data, ensure
that your dat file matches your subscription file! *
EDITING Before beginning your session you should edit your versions
INVOICES of the INVOICES.TXT and RECEIPT.TXT files provided. (Or you
RECEIPT can rename this files) The Receipt.txt file is the file that
is read in and then written back out as the receipt that is
displayed to the user. The same happens for the invoice.txt
file except that it is actually written to the disk and
maintained as the sysops invoice. (If you selected to combine
the invoices these invoices will be contained in INVOICES.
@@@). The @ Codes at the end of this documentation can be
used to tailor the invoices and receipts exactly as you would
like them. Ours are only provided as examples.
DETAILED If you intend to use the detail subscrition file you will need
SUBSCRIPT to create or edit the SUBDAT file. This filename can be any
LISTING valid filename and is placed in the block labeled "Data File
Name" under the Configuration File Information area. This file
is a detailed listing of your subscription levels. If you have
a graphics version append a "G" to the filename. For a
detailed example look at the files SUBDAT AND SUBDATG that
came along with your AS ZIP file.
AutoScribe 2.4 AUTOSCRIBE SYSTEM MANAGER
──────────────────────────────────────────────────────────────────────────
You are now ready to utilize the configuration program (ASM.EXE). This
program will assist you in setting up your configuration file
(AS.CNF). It is advised that you use the configuration program to
edit the AS.CNF file to avoid any problems with incorrect configu-
rations.
NOTE: IF YOU ARE USING MORE THAN ONE CONFIGURATION FILE FOR DIFFERENT
TYPES OF REGISTRATION, RENAME THAT CONFIG FILE TO AS.CNF AND
USE THE ASM PROGRAM TO EDIT IT. (ASM WILL ONLY EDIT AS.CNF)
The ASM file must be run in the home directory where the AutoScribe
program is found. If not you will recreate the AS.CNF file that
runs AutoScribe. To begin type ASM from the command line.
MAIN MENU (Type F1 for context sensitive help)
CONFIGURATION Highlight this option and press enter. This is the first
INFORMATION part of the configuration file. If you have not run
ASM you will see the default entries. Change these to
suit your system.
BBS Software Type - Place the code for the type of BBS
software you are running in this place. A listing of
the codes follows and may also be reviewed by pressing
F1 when this item is highlighted.
PCB145 RBBS SPITFIRE TRITEL
PCBOARD QBBS GAP OTHER
WILDCAT TBBS RA
If you run PCBoard 14.5+ enter PCB145 else enter PCBOARD
BBS Name - Place the name of your Bulletin Board System
on this line. You have a maximum of 50 characters. (This
should match your registration Bulletin Board Name exactly,
If not, contact the support board for new registration
information).
AutoScribe 2.4 AUTOSCRIBE SYSTEM MANAGER
──────────────────────────────────────────────────────────────────────────
Registration Number - Place the registration number you
received from CP or the support board on this line. If you
have not registered your version of AutoScribe, Place
00000 on this line or leave the default.
Warning File Name - This line contains either a "Y" to
utilize the built in warning file or a filename of the
warning file you may have designed for use with your
system. If you have an ansi version of the warning file
append a "G" to the filename. (DO NOT add this "G" on
this line. This line is for the non-color version only.)
Logoff File Name - This line will contain an "N" if you
do not wish to show a logoff screen, or the filename of
a logoff screen you wish to display to the user prior to
sending that user back to the board.
Data File Name - If you would like to show the user a
more detailed listing of your subscription levels, you
should create a file which describes your levels and place
its filename in this block. (SUBDAT is provided as an
example file). If you do not desire to show detailed
listings then Autoscribe will show the short listings only
if you place a "N" on this line. Append a "G" to the
graphic version filename.
Auto Registration - If you run a PCBoard 14.5+ system and
want auto registration done then place a "Y" in this block.
If you do not wish for auto registration (Security Level
and Adjusted Expire Date) then place a "N" in this block.
NOTE: ALL OTHER BBS TYPES place a "N" here since there is
currently no support for auto registration of other board
types.
Update by - This line indicates whether you want AS to use
the current Expiration Date/Todays Date/or to ASK the user
to calculate the new expiration date. Place one of the
following codes in this block:
TODAY - Use todays date
EXPIRE - Use current expiration date
ASK - Ask the user if this is a new subscription (If so
then the date is calculated from todays date, else
the expire date is used)
FINANCIAL Highlight this option and press enter. This is the
INFORMATION where the financial information is edited from. If you
have not run ASM you will see the default entries. Change
these to suit your system.
AutoScribe 2.4 AUTOSCRIBE SYSTEM MANAGER
──────────────────────────────────────────────────────────────────────────
Credit Cards - The first 7 blocks must contain a "Y" or
"N" to indicate whether or not you support those types
of credit cards. The defaults are all "N"
By indicating here that you accept the cards, The users
will be displayed this listing once inside the purchasing
portion of AutoScribe.
Using the arrow keys move up and down the listing of credit
cards that may be automatically verified by AutoScribe.
Place a "Y" or "N" on each line to designate valid cards.
Once you have entered either yes or no for each card press
F10 to save your entries.
There is extensive card checking incorporated within
AutoScribe to validate credit cards. We cannot however
guarantee that the user is not using a card that is over
the credit limit/stolen etc. All cards are checked using
a modulus math routine, length and validation numbers.
NOTE: PRESSING 'ESC' WILL ABORT ANY ENTRY. PRESSING 'F10'
WILL SAVE THE EDITED ENTRIES.
Card Processor - Place the name of your card processor on
this line. (This is the name of the company's name that
appears on the users credit card statement)
Tax Percentage - Place the percentage of tax that your
State/Province charges. If no tax is ever to be charged
for the products you offer then place .00 (Default) in
this field, else place the appropriate amount here.
(This is a calculated percentage)
Handling Percentage - Place the percentage that you will
charge for credit card handling or other handling charges
you are charging on this line. If no handling charge is
to be made then place .00 on this line (Default)
State to Charge Tax - The two (2) letter state designator
for your state should be placed on this line if your state
requires that you charge sales tax. The following other
codes may be substituted to personalize your system
regardless of what country you are in.
ALL - Charge all users tax regardless of state/
province. By placing the word ALL on this line,
everyone that subscribes will be charged tax.
This could be used if the country charges a luxury
tax on all services and does not charge different
provinces different amounts.
AutoScribe 2.4 AUTOSCRIBE SYSTEM MANAGER
──────────────────────────────────────────────────────────────────────────
No - Charge no user regardless of state/ province
any tax. This will cause all users regardless of
where they are from to be charged no tax.
Two character state - If AutoScribe finds a two
letter state code here and it matches with the
users indicated home state then that user alone
will be charged tax. If the two states do not match
then that user is not charged tax. In most cases you
will place your state letter designator here since
most states charge sales tax.
NOTE : PRESSING 'ESC' WILL ABORT ANY ENTRY, PRESSING
'F10' WILL SAVE THE ENTRIES TO DISK.
MISCELLANEOUS Highlight this option and press enter. This section is
DATA where you will edit all miscellaneous data items required
to run AutoScribe.
Receipt filename (Input) - This is the name of the file
that will be presented to your users as a receipt. Using
the all new @CODES@ you can produce your very own
personalized receipts for your users. The @CODES available
are listed later in this document. (RECEIPT.TXT is an
example file).
Invoice filename (Input) - Like the receipt file, this file
also uses the @CODES. You can design your own invoices
with any information/logos etc that you desire. (INVOICE.
TXT is an example invoice file).
Combine invoices - Placing a "Y" will allow all invoices
to be appened to each other thus producing one file with
the filename of INVOICES.@@@.
If you elect to have seperate files for each invoice,
Your invoice files are created with the title of # and a
suffix of .INV, for example, your 21st order will be
labeled "21.INV" and will be in your AutoScribe directory.
These files are written in a numerical sequence.
If you wish to start with a higher number, edit the AS.CNT
file with an ascii editor and place the number you wish to
begin with inside of this file. (It must be a numeric
input)
To begin either file over, you can delete the INVOICES.TXT
file or the AS.CNT file. Both files if not found are
recreated.
It is not within the scope of this document to describe
procedures for processing your invoices. Your credit card
merchant should provide this information for you.
AutoScribe 2.4 AUTOSCRIBE SYSTEM MANAGER
──────────────────────────────────────────────────────────────────────────
Enter Card number twice - NOT IMPLEMENTED
Turn dots on (Card Input) - When the user enters their
credit card number you may either show them dots only
by placing a "Y" on this line, or show thier numbers as
they type them in by placing a "N" on this line.
Zero out up/dn loads - NOT IMPLEMENTED
IMPORTANT ITEMS FOR SYSOPS
TRASHCAN FILE
The trashcan file is a listing of ALL credit card numbers that you do
not wish to have access to your products. If a credit card number is
placed in this file then the user of that card will be informed that
their information is invalid and it will be reported. This file has a
format of one number per line. There should be NO spaces or other
characters between the numbers.
ex. 1234567812345678
The file name of this file is TRASHCAN and cannot be changed. It is
a text file, so you may use your favorite text editor to edit the file.
the file MUST exist.
BADCARD.DAT FILE
To help you track all bad card usage, any cards that are not accepted
will be written to the BADCARD.DAT file. This is a log file that if not
found will be created. It is a listing of Times:Dates:Persons Name and
Card Number Attempted to be used.
PURCHASE FILE
A file by the name of PURCHASE.(NODE NUMBER) is produced and placed
in the AS directory each time a user conducts a purchase. This file
may be used by the sysop in conjunction with TXT-TO-MSG to leave a
message to the sysop that a purchase has occured. It is up to the
sysop to delete this file when completed with it.
For those of you that understand Ports and IRQ settings!
NOTE: If you need to specify a non-standard port address and IRQ,
then the syntax is PORT:AAAA:X where AAAA is the base address and X is the
IRQ. It doesn't matter whether PORT:AAAA:X is the third or foruth
parameter as long as it is the LAST parameter passed.
PORT is optional, and AutoScribe will default to standard addresses and
irqs if it not used based on the port number read from the BBS file.
AutoScribe will assume COM1 = 03F8 IRQ 4, COM2 = 02E8 IRQ3, COM3 = 03E8
IRQ4 and COM4 = 02E8 IRQ 3. If you have a different non-standard port
address and irq, you could then use the PORT cmd to change the defaults.
AutoScribe will also support the use of FOSSIL drivers. The syntax for
a FOSSIL driver is: PORT:F:P. The 'F' tells AutoScribe to use a Fossil
driver for it's communications. The 'P' following it tells it which port
to use for the Fossil. Example - PORT:F:1, tells AutoScribe to use a
fossil driver for port 1.
RUNNING AutoScribe
When you first run AutoScribe a 2 functions occur.
1. Your AutoScribe Users file will be created. This is the
database file that holds your users information. CREDIT CARD
information is NOT stored within any AutoScribe file with
the exception of your invoice file. (XX.INV/INVOICES.@@@)
2. The Invoice Counter file is created. Each time a user agree's
to purchase a subscription an invoice file is created.
3. Next the door begins . First is the opening screen. Then the
warning screen, then on to the first look at your
subscriptions you have available. (Unregistered Versions
will only show 1 subscription available)
4. The user is then asked to enter thier credit card number if they
decide to continue. They may abort at any time.
Note: If a user has previously filled in the data this
information will be re-displayed to the user. A database of user
information is kept in the file AS.USR.
5. The Credit Card is checked for validity. If it is valid and you
indicated in the config file that you support the card the user
will be asked to fill in each of the questions for the database.
(If the card is not supported the user is shown a screen
informing him of the error)
Cards that are supported are listed above the line where the
user types in the number. All numbers are redisplayed as dots
and are NEVER visible to the screen. (This is for user
protection, and a confidence check)
6. Once the user passes the validity check they are once again
presented with the options screen. The user selects by number
the subscription level they wish to purchase. They are asked
to confirm this selection before the information is written
to disk.
7. Upon confirmation the user is shown a screen (Receipt)
indicating the amount of sale and the option the user selected
is displayed. (This screen may be SCREEN CAPTURED for a
receipt)
8. After reading the receipt the user (If you have selected
auto-registration and your running PCB14.5+) will be
automatically upgraded. The only upgrades available at the
present time are Security Level and Expiration Date.
9. The user is then presented with the exiting screen and are
passed back to the Main Board or BBS system.
@CODES AVAILABLE FOR RECEIPTS AND INVOICES
@BBSFNAME@ USER BBS FULL NAME
@BOARD@ BOARD NAME
@DATE@ DATE IN MMDDYY FORMAT
@TIME@ TIME IN HHMMSS FORMAT
@SUBTXT@ SUBSCRIPTION TEXT (1 LINE)
@SUBPRICE@ SUBSCRIPTION PRICE
@HANDLING@ HANDLING CHARGE
@TAX@ TAX CHARGE
@TOTAL@ TOTAL CHARGE (SUBPRICE + HANDLING + TAX)
@CARDTYPE@ TYPE OF CREDIT CARD (VERBOSE)
@NEWEXPIRE@ USERS NEW EXPIRATION DATE (YYMMDD FORMAT)
@CCNAME@ CREDIT CARD OWNERS NAME
@STREET@ CREDIT CARD MAILING ADDRESS
@CITY@ CREDIT CARD MAILING CITY
@STATE@ CREDIT CARD MAILING STATE
@ZIP@ CREDIT CARD MAILING ZIPCODE
@HPHONE@ CREDIT CARD OWNERS HOME PHONE
@WPHONE@ CREDIT CARD OWNERS WORK PHONE
@PROCESSOR@ CREDIT CARD BILLING NAME
@CARDNUMBER@ CREDIT CARD NUMBER
@CCEXPIRE@ CREDIT CARD EXPIRATION DATE
@TAXSTATE@ STATE TO CHARGE TAX
@SECURITYLV@ USERS NEW SECURITY LEVEL